home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / a_man / cat1 / atmarp.z / atmarp
Encoding:
Text File  |  2002-10-03  |  9.9 KB  |  199 lines
  1.  
  2.  
  3.  
  4. aaaattttmmmmaaaarrrrpppp((((1111MMMM))))                                                          aaaattttmmmmaaaarrrrpppp((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      atmarp - display or manage IP address to virtual circuit mappings for
  10.      TCP/IP over ATM.
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      aaaattttmmmmaaaarrrrpppp ----aaaa [ ----nnnnllll ]
  14.      aaaattttmmmmaaaarrrrpppp ----ffff _p_v_c_f_i_l_e [ ----eeee _d_e_f_a_u_l_t-_b_p_s ]
  15.      aaaattttmmmmaaaarrrrpppp ----dddd _h_o_s_t                               ((((SSSSPPPPAAAANNNNSSSS eeeennnnttttrrrriiiieeeessss OOOONNNNLLLLYYYY))))
  16.      aaaattttmmmmaaaarrrrpppp ----pppp                                    ((((SSSSPPPPAAAANNNNSSSS eeeennnnttttrrrriiiieeeessss OOOONNNNLLLLYYYY))))
  17.      aaaattttmmmmaaaarrrrpppp ----ssss _h_o_s_t _i_n_t_e_r_f_a_c_e _a_a_l _v_p_i _v_c_i         ((((SSSSPPPPAAAANNNNSSSS eeeennnnttttrrrriiiieeeessss OOOONNNNLLLLYYYY))))
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      aaaattttmmmmaaaarrrrpppp ----aaaa displays the current ATM ARP table.  Each interface can be
  21.      configured to use standard UNI signaling or SPANS (Simple Protocol for
  22.      ATM Network Signaling), but not both. SPANS is a signaling protocol that
  23.      was designed at FORE Systems prior to the existance of standard ATM
  24.      signaling protocols (Note: The SPANS options are only available on Origin
  25.      and Onyx2).  When the ATM ARP table is displayed, the entries for the UNI
  26.      signaling interfaces will be displayed separately from the entries for
  27.      the SPANS signaling interfaces.  The UNI entries are displayed first,
  28.      followed by the SPANS entries.  The ATM ARP table contains IP address to
  29.      ATM address translations and IP address to virtual circuit translations
  30.      for TCP/IP over ATM.  The ATM ARP table can contain both pre-configured
  31.      permanent translations (permanent virtual circuits) and dynamically
  32.      created translations (switched virtual circuits).  The ----llll option tells
  33.      aaaattttmmmmaaaarrrrpppp to print out ATM addresses associated with each entry in the ARP
  34.      table.  The ----llll option only applies to the UNI entries and does nothing
  35.      for the SPANS entries.  The ----nnnn option tells aaaattttmmmmaaaarrrrpppp to print the IP
  36.      addresses in standard dot-notation instead of attempting to resolve the
  37.      IP address to a qualified host name.
  38.  
  39.      For the UNI entries, each entry displayed by aaaattttmmmmaaaarrrrpppp ----aaaa can have the
  40.      following information: an IP address, a virtual circuit (identified by
  41.      port, VPI, and VCI), an ATM address (if using the -l option), and these
  42.      flags indicating the state of the entry:
  43.  
  44.           COMPL          The IP address has been resolved to either an ATM
  45.                          address or a permanent virtual circuit.
  46.  
  47.           CONN           The entry has an associated virtual circuit
  48.                          (identified by port, VPI, VCI).
  49.  
  50.           PEND           The system is in the process of connecting to the
  51.                          destination represented by the entry.
  52.  
  53.           PVC            The entry resolves the IP address to a permanent
  54.                          virtual circuit (PVC).
  55.  
  56.           VALIDATE       The entry is in the process of being validated via
  57.                          Inverse ATM ARP.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaattttmmmmaaaarrrrpppp((((1111MMMM))))                                                          aaaattttmmmmaaaarrrrpppp((((1111MMMM))))
  71.  
  72.  
  73.  
  74.           NAK            The ATM ARP server has NAK'ed this IP address.  It is
  75.                          unreachable.
  76.  
  77.           NOSNAP         The associated virtual circuit is not using 802.2 LLC
  78.                          SNAPs for encapsulating IP.
  79.  
  80.      For the SPANS entries, each entry displayed by aaaattttmmmmaaaarrrrpppp ----aaaa can have the
  81.      following information: an IP address, an interface name, the AAL, a
  82.      virtual circuit (identified by VPI, and VCI), and these flags indicating
  83.      the state of the entry:
  84.  
  85.           SPANS          The entry is infact a SPANS entry.
  86.  
  87.           Pending        Address resolution has begun but has not yet
  88.                          completed.
  89.  
  90.           Complete       Address resolution is completed and the virtual
  91.                          circuit has been established.
  92.  
  93.      When aaaattttmmmmaaaarrrrpppp is invoked with the ----ffff option, it becomes a daemon that
  94.      manages permanent virtual circuits (PVCs) for TCP/IP traffic over ATM.
  95.      When aaaattttmmmmaaaarrrrpppp ----ffff is used to manage PVCs, it is usually invoked by the ATM
  96.      start-up script, /etc/init.d/atm, using the file /var/atm/pvc.conf as the
  97.      PVC table.
  98.  
  99.      The _p_v_c_f_i_l_e contains one mapping per line.  Blank lines are ignored and
  100.      any characters to the right of a # character are ignored to allow
  101.      comments in the file.  Each line has the following format:
  102.  
  103.      IP-address     port      VPI  VCI  flags
  104.  
  105.  
  106.  
  107.      _I_P-_a_d_d_r_e_s_s
  108.           This is an IP address or a hostname that can be resolved to an IP
  109.           address.
  110.  
  111.      _p_o_r_t This decimal integer is the unit number of the actual ATM interface
  112.           over which the virtual circuit to this destination is established.
  113.           Note that virtual circuits to the same sub-net can go across
  114.           different interfaces and that each port can support multiple sub-
  115.           nets.
  116.  
  117.      _V_P_I _V_C_I
  118.           These two integers are the VPI/VCI pair of the virtual circuit for
  119.           this destination.  The values can be either in decimal or
  120.           hexadecimal (preceded with 0x).
  121.  
  122.      _f_l_a_g_s
  123.           Currently, the only flag is nnnn which, if set, inhibits sending of
  124.           802.2 SNAP LLC headers on IP packets sent on that VC.
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. aaaattttmmmmaaaarrrrpppp((((1111MMMM))))                                                          aaaattttmmmmaaaarrrrpppp((((1111MMMM))))
  137.  
  138.  
  139.  
  140.      When the ----ffff option is used, atmarp forks off a daemon process to create
  141.      the virtual circuits for each valid line in _p_v_c_f_i_l_e. The daemon process
  142.      then sleeps until it is killed.  When the process is killed, the virtual
  143.      circuits will be closed and the mappings deleted.
  144.  
  145.      If the daemon process is sent a SSSSIIIIGGGGHHHHUUUUPPPP signal, it will read the _p_v_c_f_i_l_e
  146.      again, incorporate any additional mappings, and delete any removed
  147.      mappings.  This allows an administrator to modify the _p_v_c_f_i_l_e and have
  148.      the changes take effect by invoking kkkkiiiillllllllaaaallllllll ----HHHHUUUUPPPP aaaattttmmmmaaaarrrrpppp.... The ----ffff option
  149.      applies only to UNI signaling interfaces and does nothing for the SPANS
  150.      entries.
  151.  
  152.      The ----dddd option tells aaaattttmmmmaaaarrrrpppp to delete an entry from the table of SPANS
  153.      entries. The hhhhoooosssstttt entry can be specified as a hostname or IP address (in
  154.      dot-notation).  The ----dddd option applies only to SPANS entries and does
  155.      nothing for the UNI entries.
  156.  
  157.      The ----pppp option tells aaaattttmmmmaaaarrrrpppp to purge all the entries from the table of
  158.      SPANS entries.  The ----pppp option applies only to SPANS entries and does
  159.      nothing for the UNI entries.
  160.  
  161.      The ----ssss option tells aaaattttmmmmaaaarrrrpppp to set a PVC entry into the table of SPANS
  162.      entries. The hhhhoooosssstttt (remote host) can be specified as a hostname or IP
  163.      address (in dot-notation).  The iiiinnnntttteeeerrrrffffaaaacccceeee is the physical interface the
  164.      PVC is to use and is specified as the interface name as it appears in the
  165.      "netstat -i" output display. (ie. atm0) The aaaaaaaallll is the AAL type of the
  166.      connection and must be specified as 5.  The vvvvppppiiii is the Virtual Path
  167.      Identifier of the connection and must be specified as 0.  The vvvvcccciiii is the
  168.      Virtual Circuit Identifier of the connection and must be specified as a
  169.      number between 33 and 255.  The ----ssss option applies only to SPANS
  170.      interfaces and does nothing for the UNI entries.
  171.  
  172. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  173.      Here is an example pvcfile showing three hosts:
  174.  
  175.            #
  176.            #
  177.            # hostname      port      VPI      VCI      flags
  178.            # --------      ----      ---      ---      -----
  179.            atm-host1       0         0        201
  180.            atm-host2       0         0        0x34
  181.            atm-host3       1         16       203      n
  182.  
  183.  
  184. FFFFIIIILLLLEEEESSSS
  185.      /etc/init.d/atm
  186.      /var/atm/pvc.conf
  187.  
  188. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  189.      atm(7M), if_atm(7M), if_atmarp(7M), atmconfig(1M), atmstat(1M),
  190.      ifatmconfig(1M), spansd(1m), killall(1M)
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.